home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / faq / comp / aix_faq / part3 < prev   
Text File  |  1994-03-30  |  58KB  |  1,591 lines

  1. Path: bloom-beacon.mit.edu!hookup!swrinde!cs.utexas.edu!uunet!ams.amsinc.com!162.70.244.20!jwarring
  2. From: jwarring@fmsaix.amsinc.com (Jeff Warrington)
  3. Newsgroups: comp.unix.aix,comp.answers,news.answers
  4. Subject: AIX Frequently Asked Questions (Part 3 of 3)
  5. Supersedes: <1492@mavrick.UUCP>
  6. Followup-To: comp.unix.aix
  7. Date: 31 Mar 1994 02:40:20 GMT
  8. Organization: American Management Systems, Inc.
  9. Lines: 1570
  10. Approved: news-answers-request@MIT.EDU
  11. Distribution: world
  12. Expires: 30 Apr 94 01:23:45 GMT
  13. Message-ID: <3002@flAIXy.fd.amsinc.com>
  14. Reply-To: jwarring@flAIXy.fd.amsinc.com
  15. NNTP-Posting-Host: flaixy.fd.amsinc.com
  16. Summary: This posting contains a list of Frequently Asked Questions 
  17.          and their answers about AIX, IBM's version of Unix.
  18. Keywords: AIX RS/6000 questions answers
  19. Xref: bloom-beacon.mit.edu comp.unix.aix:22837 comp.answers:4353 news.answers:17015
  20.  
  21. Archive-name: aix-faq/part3
  22. Last-modified: March 23, 1994
  23. Version: 3.00
  24.  
  25.  
  26. Version: $Id: aix.faq,v 3.0 94/3/23 jwarring $
  27.  
  28. Frequently Asked Questions to AIX 3.x and IBM RS/6000
  29. _____________________________________________________
  30.  
  31. 2.04: How do I link my program with a non-shared /lib/libc.a?
  32.  
  33.   cc -o prog -bnoso -bI:/lib/syscalls.exp obj1.o obj2.o obj3.o
  34.  
  35. will do that for a program consisting of the three objects obj1.o, etc.
  36.  
  37. From: Marc Pawliger (marc@sti.com)
  38.  
  39. As of AIX 3.2.5, you can install a speedup for AIXwindows called
  40. Shared Memory Transport.  To static link an X application after the
  41. SMT PTF has been installed, you must link with
  42. -bI:/usr/lpp/X11/bin/smt.exp and the executable will NOT run on a
  43. machine where SMT is not installed.  See /usr/lpp/X11/README.SMT
  44.  
  45. 2.05: How do I make my own shared library?
  46.  
  47. To make your own shared object or library of shared objects, you should
  48. know that a shared object cannot have undefined symbols.  Thus, if your
  49. code uses any externals from /lib/libc.a, the latter MUST be linked with
  50. your code to make a shared object.  Mike Heath (mike@pencom.com) said it
  51. is possible to split code into more than one shared object when externals
  52. in one object refer to another one.  You must be very good at
  53. import/export files.  Perhaps he or someone can provide an example. 
  54.  
  55. Assume you have one file, sub1.c, containing a routine with no external
  56. references, and another one, sub2.c, calling stuff in /lib/libc.a.  You
  57. will also need two export files, sub1.exp, sub2.exp.  Read the example
  58. below together with the examples on the ld man page. 
  59.  
  60. ---- sub1.c ----
  61.     int addint(int a, int b)
  62.     {
  63.       return a + b;
  64.     }
  65. ---- sub2.c ----
  66.     #include <stdio.h>
  67.  
  68.     void printint(int a)
  69.     {
  70.       printf("The integer is: %d\n", a);
  71.     }
  72. ---- sub1.exp ----
  73.     #!
  74.     addint
  75. ---- sub2.exp ----
  76.     #!
  77.     printint
  78. ---- usesub.c ----
  79.     main()
  80.     {
  81.       printint( addint(5,8) );
  82.     }
  83.  
  84. The following commands will build your libshr.a, and compile/link the
  85. program usesub to use it.  Note that you need the ld option -lc for
  86. sub2shr.o since it calls printf from /lib/libc.a.
  87.  
  88.   $ cc  -c sub1.c
  89.   $ ld -o sub1shr.o sub1.o -bE:sub1.exp -bM:SRE -T512 -H512 
  90.   $ cc  -c sub2.c
  91.   $ ld -o sub2shr.o sub2.o -bE:sub2.exp -bM:SRE -T512 -H512  -lc
  92.   $ ar r libshr.a sub1shr.o sub2shr.o
  93.   $ cc -o usesub usesub.c -L: libshr.a
  94.   $ usesub
  95.   The integer is: 13
  96.   $
  97.  
  98.  
  99. 2.06: Linking my program fails with strange errors.  Why?
  100.  
  101. Very simple, the linker (actually called the binder), cannot get the
  102. memory it needs, either because your ulimits are too low or because you
  103. don't have sufficient paging space.  Since the linker is quite different
  104. >from normal Unix linkers and actually does much more than these, it also
  105. uses a lot of virtual memory.  It is not unusual to need 10000 pages (of
  106. 4k) or more to execute a fairly complex linking.
  107.  
  108. If you get 'BUMP error', either ulimits or paging is too low, if you get
  109. 'Binder killed by signal 9' your paging is too low.
  110.  
  111. First, check your memory and data ulimits; in korn shell 'ulimit -a' will
  112. show all limits and 'ulimit -m 99999' and 'ulimit -d 99999' will
  113. increase the maximum memory and data respectively to some high values. 
  114. If this was not your problem, you don't have enough paging space.
  115.  
  116. If you will or can not increase your paging space, you could try this:
  117.  
  118. - Do you duplicate libraries on the ld command line? That is never
  119.   necessary.
  120.  
  121. - Do more users link simultaneously? Try having only one linking going
  122.   on at any time.
  123.  
  124. - Do a partwise linking, i.e. you link some objects/libraries with the
  125.   -r option to allow the temporary output to have unresolved references,
  126.   then link with the rest of your objects/libraries.  This can be split
  127.   up as much as you want, and will make each step use less virtual memory.
  128.  
  129.   If you follow this scheme, only adding one object or archive at a
  130.   time, you will actually emulate the behavior of other Unix linkers.
  131.  
  132. If you decide to add more paging space, you should consider adding a new
  133. paging space on a second hard disk, as opposed to just increasing the
  134. existing one.  Doing the latter could make you run out of free space on
  135. your first harddisk. It is more involved to shrink a paging space
  136. but easier to delete one.
  137.  
  138.  
  139. 2.07: What's with malloc()?
  140.  
  141. malloc() uses a late allocation algorithm based on 4.3 BSD's malloc()
  142. for speed.  This lets you allocate very large sparse memory spaces,
  143. since the pages are not actually allocated until they are touched for
  144. the first time.  Unfortunately, it doesn't die gracefully in the face of
  145. loss of available memory.  See the "Paging Space Overview" under
  146. InfoExplorer, and see the notes on the linker in this document for an
  147. example of an ungraceful death.
  148.  
  149. If you want your program to get notified when running out of memory, you
  150. should handle the SIGDANGER signal.  The default is to ignore it. 
  151. SIGDANGER is sent to all processes when paging space gets low, and if
  152. paging space gets even lower, processes with the highest paging space
  153. usage are sent the SIGKILL signal.
  154.  
  155. malloc() is substantially different in 3.2, allocating memory more
  156. tightly.  If you have problems running re-compiled programs on 3.2, try
  157. running them with MALLOCTYPE=3.1. 
  158.  
  159. Early Page Space Allocation (EPSA) added to AIX 3.2: see
  160. /usr/lpp/bos/README.PSALLOC - IX38211 / U422496 Allows setting of
  161. early allocation (vs. default late allocation) on a per-process basis.
  162.  
  163. 2.08: Why does xlc complain about 'extern char *strcpy()'
  164.  
  165. The header <string.h> has a strcpy macro that expands strcpy(x,y) to
  166. __strcpy(x,y), and the latter is then used by the compiler to generate
  167. inline code for strcpy.  Because of the macro, your extern declaration
  168. contains an invalid macro expansion.  The real cure is to remove your
  169. extern declaration but adding -U__STR__ to your xlc will also do the trick.
  170.  
  171.  
  172. 2.09: Why do I get 'Parameter list cannot contain fewer ....'
  173.  
  174. This is the same as above.
  175.  
  176.  
  177. 2.10: Why does xlc complain about '(sometype *)somepointer = something'
  178.  
  179. Software that is developed using gcc may have this construct. However,
  180. standard C does not permit casts to be lvalues, so you will need to
  181. change the cast and move it to the right side of the assignment. If you
  182. compile with 'cc', removing the cast completely will give you a warning,
  183. 'xlc' will give you an error (provided somepointer and something are of
  184. different types - but else, why would the cast be there in the first place?)
  185.  
  186.  
  187. 2.11: Some more common errors
  188.  
  189. Here are a few other common errors with xlc:
  190.  
  191. 305 |     switch((((np)->navigation_type) ? (*((np)->navigation_type)) :
  192.       ((void *)0)))
  193.       .a...........  
  194. a - 1506-226: (S) The second and third operands of the conditional
  195. operator must be of the same type.
  196.  
  197. The reason for this is that xlc defines NULL as (void *)0, and it does
  198. not allow two different types as the second and third operand of ?:. 
  199. The second argument above is not a pointer and the code used NULL
  200. incorrectly as a scalar. NULL is a nil pointer constant in ANSI C and
  201. in some traditional compilers.
  202.  
  203. You should change NULL in the third argument above to an integer 0.
  204.  
  205.  
  206. 2.12: Can the compiler generate assembler code?
  207.  
  208. Starting with version 1.3 of xlc and xlf the -S option will generate a
  209. .s assembly code file prior to optimization. The option -qlist will
  210. generate a human readable one in a .lst file.
  211.  
  212. There is also a disassembler in /usr/lpp/xlc/bin/dis include with the
  213. 1.3 version of xlc (and in /usr/lpp/xlC/bin/dis with the 2.1 version
  214. of xlC) that will disassemble existing object or executable files.
  215.  
  216.  
  217. 2.13: Curses
  218.  
  219. Curses based applications should be linked with -lcurses and _not_ with
  220. -ltermlib. It has also been reported that some problems with curses are
  221. avoided if your application is compiled with -DNLS.
  222.  
  223. Peter Jeffe <peter@ski.austin.ibm.com> also notes:
  224.  
  225. >the escape sequences for cursor and function keys are *sometimes*
  226. >treated as several characters: eg. the getch() - call does not return
  227. >KEY_UP but 'ESC [ C.'
  228.  
  229. You're correct in your analysis: this has to do with the timing of the
  230. escape sequence as it arrives from the net. There is an environment
  231. variable called ESCDELAY that can change the fudge factor used to decide
  232. when an escape is just an escape. The default value is 500; boosting
  233. this a bit should solve your problems.
  234.  
  235. Christopher Carlyle O'Callaghan <asdfjkl@wam.umd.edu> has more comments
  236. concerning extended curses:
  237.  
  238. 1) The sample program in User Interface Programming Concepts, page 7-13
  239.    is WRONG. Here is the correct use of panes and panels.
  240.  
  241. #include <cur01.h>
  242. #include <cur05.h>
  243.  
  244. main()
  245. {
  246. PANE *A, *B, *C, *D, *E, *F, *G, *H;
  247. PANEL *P;
  248.  
  249. initscr();
  250.  
  251. A = ecbpns (24, 79, NULL, NULL, 0, 2500, Pdivszp, Pbordry, NULL, NULL);
  252. D = ecbpns (24, 79, NULL, NULL, 0, 0,    Pdivszf, Pbordry, NULL, NULL);
  253. E = ecbpns (24, 79, D,    NULL, 0, 0,    Pdivszf, Pbordry, NULL, NULL);
  254. B = ecbpns (24, 79, A, D, Pdivtyh, 3000, Pdivszp, Pbordry, NULL, NULL);
  255. F = ecbpns (24, 79, NULL, NULL, 0, 0,    Pdivszf, Pbordry, NULL, NULL);
  256. G = ecbpns (24, 79, F,    NULL, 0, 5000, Pdivszp, Pbordry, NULL, NULL);
  257. H = ecbpns (24, 79, G,    NULL, 0, 3000, Pdivszp, Pbordry, NULL, NULL);
  258. C = ecbpns (24, 79, B, F, Pdivtyh, 0, Pdivszf, Pbordry, NULL, NULL);
  259. P = ecbpls (24, 79, 0, 0, "MAIN PANEL", Pdivtyv, Pbordry, A);
  260.  
  261. ecdvpl (P);
  262. ecdfpl (P, FALSE);
  263. ecshpl (P); 
  264. ecrfpl (P);
  265. endwin();
  266. }
  267.  
  268. 2) DO NOT include <curses.h> and any other <cur0x.h> file together.
  269.    You will get a bunch of redefined statements.
  270.  
  271. 3) There is CURSES and EXTENDED CURSES. Use only one or the other. If the
  272.    manual says that they're backwards compatible or some other indication 
  273.    that you can use CURSES routines with EXTENDED, don't believe it. To 
  274.    use CURSES you need to include <curses.h> and you can't (see above).
  275.  
  276. 4) If you use -lcur and -lcurses in the same link command, you will get
  277.    Memory fault (core dump) error. You CANNOT use both of them at the same
  278.    time. -lcur is for extended curses, -lcurses is for regular curses.
  279.  
  280. 5) When creating PANEs, when you supply a value (other than 0) for the
  281.    'ds' parameter and use Pdivszf value for the 'du' parameter, the 'ds'
  282.    will be ignored (the sample program on page 7-13 in User Interface
  283.    Programming Concepts is wrong.) For reasons as yet undetermined,
  284.    Pdivszc doesn't seem to work (or at least I can't figure out how to
  285.    use it.)
  286.  
  287. 6) If you're running into bugs and can't figure out what is happening,
  288.    try the following:
  289.    include -qextchk -g in your compile line
  290.     -qextchk will check to make sure you're passing the right number of
  291.        parameters to the functions
  292.     -g enables debug
  293.  
  294. 7) Do not use 80 as the number of columns if you want to use the whole
  295.    screen. The lower right corner will get erased.  Use 79 instead.
  296.  
  297. 8) If you create a panel, you must create at least 1 pane, otherwise you
  298.    will get a Memory fault (core dump).
  299.  
  300. 9) When creating a panel, if you don't have a border around it, any title
  301.    you want will not show up.
  302.  
  303. 10) to make the screen scroll down:
  304.     wmove (win, 0, 0);
  305.     winsertln (win)
  306.  
  307. 11) delwin(win) doesn't work in EXTENDED WINDOWS
  308.  
  309.     To make it appear as if a window is deleted, you need to do the following:
  310.     for every window that you want to appear on the screen
  311.     touchwin(win)
  312.     wrefresh(win)
  313.  
  314.     you must make sure that you do it in the exact same order as you put
  315.     them on the screen (i.e., if you called newwin with A, then C, then B,
  316.     then you must do the loop with A, then C, then B, otherwise you won't
  317.     get the same screen back).  The best thing to do is to put them into
  318.     an array and keep track of the last window index.
  319.  
  320. 12) mvwin(win, line, col) implies that it is only used for viewports and
  321.     subwindows. It can also be used for the actual windows themselves.
  322.  
  323. 13) If you specify the attribute of a window using wcolorout(win), any
  324.     subsequent calls to chgat(numchars, mode) or any of its relatives
  325.     will not work. (or at least they get very picky.)
  326.  
  327.  
  328. 2.14: How do I speed up linking
  329.  
  330. Please refer to sections 2.03 and 2.06 above.
  331.  
  332. From: losecco@undpdk.hep.nd.edu (John LoSecco) and
  333.       hook@chaco.aix.dfw.ibm.com (Gary R. Hook)
  334.  
  335. >From oahu.cern.ch in /pub/aix3 you can get a wrapper for the existing
  336. linker called tld which can reduce link times with large libraries by
  337. factors of 3 to 4.
  338.  
  339.  
  340. 2.15: What is deadbeef?
  341.  
  342. When running the debugger (dbx), you may have wondered what the
  343. 'deadbeef' is you occasionally see in registers.  Do note, that
  344. 0xdeadbeef is a hexadecimal number that also happens to be some kind
  345. of word (the RS/6000 was built in Texas!), and this hexadecimal number
  346. is simply put into unused registers at some time, probably during
  347. program startup.
  348.  
  349.  
  350. 2.16: How do I statically link in 3.2?
  351.  
  352. xlc -bnso -bI:/lib/syscalls.exp -liconv -bnodelcsect 
  353.  
  354.  
  355. 2.17: How do I make an export list from a library archive?
  356. From: dad@adonis.az05.bull.com (Dave Dennerline)
  357.  
  358. This script will only extract the "export"able names and should be
  359. useful in starting the shared library creation process. The user must
  360. determine which names should be included in the import and export lists.
  361. It's only been tested on a few library archives.
  362.  
  363. #!/bin/ksh
  364. #
  365. # mkexps - make export list
  366. # This program creates an export list by combining all the "." and normal names
  367. # into one list. 
  368. #
  369. if [[ "$#" -ne 1 ]]
  370. then
  371.     print "Usage: mkexps ArchiveFile"
  372.     exit -2
  373. fi
  374. if [[ ! -f $1 ]] 
  375. then
  376.     print "mkexps: Cannot open file \"$1\""
  377.     exit -1
  378. fi
  379. dump -g $1 | awk '
  380. BEGIN {
  381.         top = 1
  382. }    
  383. /^[ ]*[0-9][0-9]*/ {
  384.     if ( (n = index( $2, "." )) > 0 ) {
  385.         export_array[ top++ ] = substr( $2, n+1, length( $2 ))
  386.     }
  387.     else {
  388.     export_array[ top++ ] = $2
  389.     }
  390. }
  391.  
  392. END {
  393.     for ( i = 1; i < top; i++ )
  394.     {
  395.     print export_array[ i ]
  396.     }
  397.  
  398. }' | sort | uniq
  399.  
  400. _____________________________________________________
  401. 3.00: Fortran and other compilers
  402.  
  403. This section covers all compilers other than C/C++.  On Fortran, there
  404. seem to have been some problems with floating point handling, in
  405. particular floating exceptions.
  406.  
  407.  
  408. 3.01: I have problems mixing Fortran and C code, why?
  409.  
  410. A few routines (such as getenv, signal, and system) exist in both the
  411. Fortran and C libraries but with different parameters. In the recent
  412. past, if you have a mixed program that calls getenv from both C and
  413. Fortran code, you have to link them carefully by specifying the correct
  414. library first on your command line. This is no longer needed starting
  415. with version 1.5 of the compilers.
  416.  
  417.  
  418. 3.02: How do I statically bind Fortran libraries and dynamically
  419.       bind C libraries?
  420. From: amaranth@vela.acs.oakland.edu (Paul Amaranth)
  421.  
  422. [ Editor's note: Part of this is also discussed above under the C compiler
  423.   section, but I felt it was so valuable that I have left it all in. 
  424.   I've done some minor editing, mostly typographical. ]
  425.  
  426. The linker and binder are rather versatile programs, but it is not
  427. always clear how to make them do what you want them to.  In particular,
  428. there are times when you do not want to use shared libraries, but
  429. rather, staticly bind the required routines into your object.  Or, you
  430. may need to use two versions of the same routine (eg, Fortran & C).  Here
  431. are the results of my recent experiments.  I would like to thank Daniel
  432. Premer and Brad Hollowbush, my SE, for hints.  Any mistakes or omissions
  433. are my own and I have tended to interchange the terms "linker" and
  434. "binder".  These experiments were performed on AIX 3.1.2.  Most of this
  435. should be applicable to later upgrades of 3.1.
  436.  
  437. 1)  I have some C programs, I want to bind in the runtime routines.  How
  438.     do I do this? [Mentioned in section 2.04 of this article as well, ed.]
  439.  
  440.     You can put the -bnso binder command on the link line.  You should
  441.     also include the -bI:/lib/syscalls.exp control argument:
  442.       
  443.       $ cc *.o -bnso -bI:/lib/syscalls.exp -o foo
  444.  
  445.     This will magically do everything you need.  Note that this will bind
  446.     _all_ required routines in.  The -bI argument tells the linker that
  447.     these entry points will be resolved dynamically at runtime (these are
  448.     system calls).  If you omit this you will get lots of unresolved 
  449.     reference messages.
  450.  
  451. 2)  I want to statically bind in the Fortran runtime so a) my customers 
  452.     do not need to buy it and b) I don't have to worry about the runtime
  453.     changing on a new release.  Can I use the two binder arguments in
  454.     1) to do this?
  455.  
  456.     You should be able to do so, but, at least under 3002, if you do
  457.     you will get a linker error referencing getenv.  In addition, there
  458.     are a number of potential conflicts between Fortran and C routines.
  459.     The easy way just does not work.  See the section on
  460.     2 stage linking for C and Fortran on how to do this.  The getenv
  461.     problem is a mess, see the section on Comments & Caveats for more.
  462.  
  463. 3)  I have a mixture of C and Fortran routines, how can I make sure
  464.     that the C routines reference the C getenv, while the Fortran routines
  465.     reference the Fortran getenv (which has different parameters and, if
  466.     called mistakenly by a C routine results in a segmentation fault)?
  467.  
  468.     From Mike Heath (mike@pencom.com):
  469.  
  470.     Use -brename:symbol1,symbol2 when pre-linking the modules from one
  471.     of the languages. It does not matter which one you choose.
  472.  
  473. 4)  I have C and Fortran routines.  I want to bind in the xlf library, while
  474.     letting the rest of the libraries be shared.  How do I do this?
  475.  
  476.     You need to do a 2 stage link.  In the first stage, you bind in the
  477.     xlf library routines, creating an intermediate object file.  The
  478.     second stage resolves the remaining references to the shared libraries.
  479.  
  480.     This is a general technique that allows you to bind in specific system
  481.     routines, while still referencing the standard shared libraries.
  482.  
  483.     Specifically, use this command to bind the xlf libraries to the Fortran
  484.     objects:
  485.  
  486.        $ ld -bh:4 -T512 -H512 <your objects> -o intermediat.o \
  487.          -bnso -bI:/lib/syscalls.exp -berok -lxlf -bexport:/usr/lib/libg.exp \
  488.          -lg -bexport:<your export file>
  489.  
  490.     The argument -bexport:<your export file> specifies a file with the
  491.     name of all entry points that are to be visible outside the intermediate 
  492.     module.  Put one entrypoint name on a line.  The -bI:/lib/libg.exp line 
  493.     is required for proper functioning of the program.  The -berok argument 
  494.     tells the binder that it is ok to have unresolved references, at least 
  495.     at this time (you would think -r would work here, but it doesn't seem to).  
  496.     The -bnso argument causes the required modules to be imported
  497.     into the object.  The -lxlf, of course, is the xlf library.
  498.  
  499.     Then, bind the intermediate object with the other shared libraries in
  500.     the normal fashion:
  501.  
  502.        $ ld -bh:4 -T512 -H512 <C or other modules> intermediate.o \
  503.          /lib/crt0.o -lm -lc
  504.  
  505.     Note the absence of -berok.  After this link, all references should
  506.     be resolved (unless you're doing a multistage link and making another
  507.     intermediate).
  508.  
  509.     NOTE THE ORDER OF MODULES.  This is extremely important if, for example,
  510.     you had a subroutine named "load" in your Fortran stuff.  Putting the
  511.     C libraries before the intermediate module would make the C "load"
  512.     the operable definition, rather than the Fortran version EVEN THOUGH 
  513.     THE FORTRAN MODULE HAS ALREADY BEEN THROUGH A LINK AND ALL REFERENCES 
  514.     TO THE SYMBOL ARE CONTAINED IN THE FORTRAN MODULE.  This can
  515.     be extremely difficult to find (trust me on this one :-)  Is this
  516.     a bug, a feature, or what?
  517.     
  518.     [As mentioned in section 2.03 of this article, it is a feature that you
  519.     can replace individual objects in linked files, ed.]
  520.  
  521.     The result will be a slightly larger object than normal.  (I say slightly
  522.     because mine went up 5%, but then it's a 2 MB object :-)
  523.  
  524.  
  525. Comments & Caveats:
  526.  
  527.    From the documentation the -r argument to the linker should do what
  528.    -berok does.  It does not.  Very strange results come from using the
  529.    -r argument.  I have not been able to make -r work in a sensible manner
  530.    (even for intermediate links which is what it is supposed to be for).
  531.  
  532.        Note from Mike Heath (mike@pencom.com):
  533.  
  534.        'ld -r' is essentially shorthand for 'ld -berok -bnogc -bnoglink'.
  535.        Certainly, using -berok with an export file (so garbage collection
  536.        can be done) is preferable to ld -r, but the latter is easier.
  537.  
  538.    When binding an intermediate module, use an export file to define the
  539.    entry points you want visible in the later link.  If you don't do this,
  540.    you'll get the dreaded "unresolved reference" error.  Import files name
  541.    entry points that will be dynamically resolved (and possibly where).
  542.  
  543.    If you are in doubt about what parameters or libraries to link, use the
  544.    -v arg when linking and modify the exec call that shows up into 
  545.    an ld command.  Some thought about the libraries will usually yield an
  546.    idea of when to use what.  If you don't know what an argument is for,
  547.    leave it in.  It's there for a purpose (even if you don't understand it).
  548.  
  549.    Watch the order of external definitions (ie, libraries) when more than
  550.    one version of a routine may show up, eg "load".  The first one defined
  551.    on the ld command line is the winner.  
  552.  
  553.    The getenv (and system and signal) problem is a problem that started out
  554.    minor, got somewhat worse in 3003 and, eventually will be correctly fixed.
  555.    Basically, you should extract the 3002 version of these three routines
  556.    from xlf.a before doing the update and save them away, then link these
  557.    routines in if you use these Fortran system services.  
  558.  
  559.  
  560. 3.03: How do I check if a number is NaN?
  561. From: sdl@glasnost.austin.ibm.com (Stephen Linam)
  562.  
  563. NaN is "Not a Number".  It arises because the RISC System/6000 uses
  564. IEEE floating point arithmetic.
  565.  
  566. To determine if a variable is a NaN you can make use of the property
  567. that a NaN does not compare equal to anything, including itself.
  568. Thus, for real variable X, use
  569.  
  570.     IF (X .NE. X) THEN    ! this will be true if X is NaN
  571.  
  572. Floating point operations which cause exceptions (such as an overflow)
  573. cause status bits to be set in the Floating Point Status and Control
  574. Register (FPSCR).  There is a Fortran interface to query the FPSCR, and
  575. it is described in the XLF Fortran manuals -- I don't have the manuals
  576. right here, but look for FPGETS and FPSETS.
  577.  
  578. The IBM manual "Risc System/6000 Hardware Technical Reference - General
  579. Information" (SA23-2643) describes what floating point exceptions can
  580. occur and which bits are set in the FPSCR as a result of those exceptions.
  581.  
  582.  
  583. 3.04: Some info sources on IEEE floating point
  584.  
  585. 1. ANSI/IEEE STD 754-1985 (IEEE Standard for Binary Floating-Point
  586.    Arithmetic) and ANSI/IEEE STD 854-1987 (IEEE Standard for
  587.    Radix-Independent Floating-Point Arithmetic), both available from IEEE. 
  588.  
  589. 2. David Goldberg, "What Every Computer Scientist Should Know About
  590.    Floating-Point Arithmetic", ACM Computing Surveys, Vol. 23, No. 1,
  591.    March 1991, pp. 5-48.
  592.  
  593. ____________________________________________________________________________
  594. 4.00: GNU and Public Domain software
  595.  
  596. GNU software comes from the Free Software Foundation and various other
  597. sources. A number of ftp sites archive them. Read the GNU license for 
  598. rules on distributing their software.
  599.  
  600. Lots of useful public domain software have been and continue to be ported
  601. to the RS/6000. See below for ftp or download information.
  602.  
  603.  
  604. 4.01: How do I find sources?
  605. From: jik@GZA.COM (Jonathan Kamens)
  606.  
  607. There is a newsgroup devoted to posting about how to get a certain
  608. source.  One is strongly urged to follow the guidelines in the article
  609. How_to_find_sources(READ_THIS_BEFORE_POSTING), available via anonymous
  610. ftp from rtfm.mit.edu (18.70.0.209):
  611.  
  612. /pub/usenet/comp.sources.wanted/H_t_f_s_(R_T_B_P)
  613.  
  614. Note: You should try to use hostnames rather than ip addresses since
  615. they are much less likely to change.
  616.  
  617. Also available from mail-server@rtfm.mit.edu by sending a mail
  618. message containing:
  619.  
  620. send usenet/comp.sources.wanted/H_t_f_s_(R_T_B_P)
  621.  
  622. Send a message containing "help" to get general information about the
  623. mail server.
  624.  
  625. If you don't find what you were looking for by following these
  626. guidelines, you can post a message to comp.sources.wanted.
  627.  
  628.  
  629. 4.02: Are there any ftp sites?
  630.  
  631. Below are some ftp sites that are supposed to have RS/6000 specific
  632. software.  I haven't verified all the entries.
  633.  
  634. US sites:
  635. aixpdslib.seas.ucla.edu        128.97.2.211    pub
  636. acd.ucar.edu                128.117.32.1     pub/AIX         
  637. acsc.acsc.com               143.127.0.2        pub
  638. byron.u.washington.edu      128.95.48.32    pub/aix/RS6000 (older stuff)
  639. lightning.gatech.edu        128.61.10.8        pub/aix
  640. tesla.ee.cornell.edu        128.84.253.11    pub
  641.  
  642. European sites:
  643. nic.funet.fi                128.214.6.100    pub/unix/AIX/RS6000
  644. iacrs1.unibe.ch             130.92.11.3        pub
  645. files1zrz.zrz.TU-Berlin.DE  130.149.4.50    pub/aix
  646. ftp-aix.polytechnique.fr    129.104.3.60    pub/binaries/rios
  647.  
  648. The first one is dedicated to software running on AIX.  It might not
  649. always be the latest versions of the software, but it has been ported to
  650. AIX (normally AIX version 3 only).  Once connected, you should retrieve
  651. the files README and pub/ls-lR.
  652.  
  653. Please use the European sites very sparingly.  They are primarily to
  654. serve people in Europe and most of the software can be found in the US
  655. sites originally.
  656.  
  657. From: reed@prism.sps.mot.com (Tim Reed)
  658.  
  659. Following is a list of possible anonymous ftp sites for information
  660. and programs for the AIX/RS600. Some of the sites were suggested from
  661. other usenet users - those are listed first. The remaining sites were
  662. obtained by a simple search of archie for the names aix, AIX, rs6000
  663. and RS6000. 
  664.  
  665. Sites received from usenet users:
  666.  
  667. Host ibminet.awdpa.ibm.com
  668.     Location: pub/announcements   #IBM announcements
  669.     Location: pub/oemhw           #oem hardware
  670.     Location: pub/ptfs            #PTFs
  671.  
  672. Host cac.toronto.ibm.com
  673.     Location: marketing-info
  674.  
  675. >From David Edelsohn (c1dje@watson.ibm.com):
  676. Host aixpdslib.seas.ucla.edu
  677.     Location: ?                   #AIX archive (sources and binaries)
  678. Host ftp.egr.duke.edu
  679.     Location: ?                   #AIX archive
  680. Host straylight.acs.ncsu.edu
  681.     Location: ?                   #AIX archive
  682. Host alpha.gnu.ai.mit.edu
  683.     Location: /rs6000          #AIX archive
  684.  
  685. >From Frank E. Doss (csfed@ux1.cts.eiu.edu):
  686. Host iacrs2.unibe.ch
  687.     Location: /pub/aix            #bunch of goodies)
  688. Host ftp.u.washington.edu
  689.     Location: /pub/RS6000         #minimal -- ted)
  690. Host aixive.unb.ca
  691.     Location: ?                   #just announced -- new archive)
  692. Host ftp.ans.net
  693.     Location: /pub/misc           #wais goodies)
  694. Host uvaarpa.virginia.edu
  695.     Location: /pub/misc           #minimal -- whois)
  696. Host ux1.cts.eiu.edu
  697.     Location: /pub/rs6000         #minimal -- pop3, FAQ, whois)
  698.  
  699. >From Robert MacKinnon (robmack@bsc.no):
  700. Host ftp.bsc.no
  701.     Location: pub/Src.
  702.  
  703.  
  704. Sites with directories named 'aix':
  705.  
  706. Host aix1.segi.ulg.ac.be   (139.165.32.13)
  707.     Location: /pub/aix
  708.  
  709. Host byron.u.washington.edu   (128.95.48.32)
  710.    Location: /pub/aix
  711.  
  712. Host cunixf.cc.columbia.edu   (128.59.40.130)
  713.     Location: /aix
  714.  
  715. Host files1zrz.zrz.tu-berlin.de   (130.149.4.50)
  716.     Location: /pub/aix
  717.  
  718. Host ftp.rz.uni-augsburg.de   (137.250.113.20)
  719.     Location: /pub/aix
  720.  
  721. Host fyvie.cs.wisc.edu   (128.105.8.18)
  722.     Location: /pub/aix
  723.  
  724. Host solaria.cc.gatech.edu   (130.207.7.245)
  725.     Location: /pub/incoming/aix
  726.     Location: /pub/aix
  727.  
  728. Host spot.colorado.edu   (128.138.129.2)
  729.     Location: /aix
  730.     Location: /pub/patches/aix
  731.  
  732. Host swdsrv.edvz.univie.ac.at   (131.130.1.4)
  733.     Location: /unix/systems/aix
  734.  
  735. Host switek.uni-muenster.de   (128.176.120.210)
  736.     Location: /pub/aix
  737.  
  738. Host wuarchive.wustl.edu   (128.252.135.4)
  739.     Location: /systems/aix
  740.  
  741.  
  742. Sites with directories named 'AIX':
  743.  
  744. Host cs.nyu.edu   (128.122.140.24)
  745.     Location: /pub/AIX
  746.  
  747. Host karazm.math.uh.edu   (129.7.128.1)
  748.     Location: /pub/AIX
  749.  
  750. Host minnie.zdv.uni-mainz.de   (134.93.178.128)
  751.     Location: /pub0/pub/AIX
  752.  
  753. Host oersted.ltf.dth.dk   (129.142.66.16)
  754.     Location: /pub/AIX
  755.  
  756. Host rs3.hrz.th-darmstadt.de   (130.83.55.75)
  757.     Location: /pub/incoming/AIX
  758.  
  759.  
  760. Sites with directories named 'rs6000':
  761.  
  762. Host aeneas.mit.edu   (18.71.0.38)
  763.     Location: /pub/rs6000
  764.  
  765. Host cameron.egr.duke.edu   (128.109.156.10)
  766.     Location: /rs6000
  767.  
  768. Host ifi.informatik.uni-stuttgart.de   (129.69.211.1)
  769.     Location: /pub/rs6000
  770.  
  771. Host metropolis.super.org   (192.31.192.4)
  772.     Location: /pub/rs6000
  773.  
  774. Host ramses.cs.cornell.edu   (128.84.218.75)
  775.     Location: /pub/rs6000
  776.  
  777. Host server.uga.edu   (128.192.1.9)
  778.     Location: /pub/rs6000
  779.  
  780. Host unidata.ucar.edu   (128.117.140.3)
  781.     Location: /pub/bin/rs6000
  782.  
  783. Host uvaarpa.virginia.edu   (128.143.2.7)
  784.     Location: /pub/rs6000
  785.  
  786. Host wayback.cs.cornell.edu   (128.84.254.7)
  787.     Location: /pub/rs6000
  788.  
  789.  
  790. Sites with directories named 'RS6000':
  791.  
  792. Host alice.fmi.uni-passau.de   (132.231.1.180)
  793.     Location: /pub/RS6000
  794.  
  795. Host byron.u.washington.edu   (128.95.48.32)
  796.     Location: /pub/aix/RS6000
  797.  
  798. Host milton.u.washington.edu   (128.95.136.1)
  799.     Location: /pub/RS6000
  800.  
  801. Host pascal.math.yale.edu   (128.36.23.1)
  802.     Location: /pub/RS6000
  803.  
  804. Host uxc.cso.uiuc.edu   (128.174.5.50)
  805.     Location: /pub/RS6000
  806.  
  807.  
  808. 4.03: General hints
  809.  
  810. In general, curses based applications should be linked with -lcurses and
  811. _not_ with -ltermlib.  It has also been reported that compiling with
  812. -DNLS helps curses based programs.
  813.  
  814. Note that the RS/6000 has two install programs, one with System V flavor
  815. in the default PATH (/etc/install with links from /usr/bin and /usr/usg),
  816. and one with BSD behavior in /usr/ucb/install.
  817.  
  818. When adding new shells to the system, add them to the "shells=" line
  819. in /etc/security/login.cfg so they can be used during ftp and rlogin
  820. by users who use them as their default shell.
  821.  
  822.  
  823. 4.04: GNU Emacs
  824.  
  825. Version 18.57 of GNU Emacs started to have RS/6000 support.  Use
  826. s-aix3-2.h for AIX 3.2. Emacs is going through rapid changes recently.
  827. Current release is 19.x.
  828.  
  829. Emacs will core-dump if it is stripped, so don't strip when you install
  830. it.  You can edit a copy of the Makefile in src replacing all 'install -s' 
  831. with /usr/ucb/install.
  832.  
  833.  
  834. 4.05: gcc/gdb
  835.  
  836. GNU C version 2.0 and later supports the RS/6000, and compiles straight
  837. out of the box.  You may, however, experience that compiling it requires
  838. large amounts of paging space.
  839.  
  840. Compiling gcc and gdb requires a patch to the 'as' assembler.  Call
  841. IBM software support and request patch for apar IX26107 (U409205).
  842.  
  843. gcc has undergone many changes lately and the current version is 2.5.x.
  844. gdb is at 4.1x.
  845.  
  846. If your machine crashed when trying to run gdb 4.7, call software support
  847. and request ptf U412815.
  848.  
  849.  
  850. 4.06: GNU Ghostscript
  851.  
  852. The PostScript interpreter GNU Ghostscript Version 2.3 and later supports
  853. the RS/6000 and can be found on various ftp sites. Current version is 2.5.2.
  854.  
  855. 4.07: TeX
  856.  
  857. TeX can be retrieved via ftp from ftp.uni-stuttgart.de.
  858. Be sure to use a recent C compiler (01.02.0000.0013) and you can compile
  859. with optimization.
  860.  
  861.  
  862. 4.08: perl
  863.  
  864. Current version is 4.035 and compiling with cc should give no problems. 
  865. If you use bsdcc, do not use perl's builtin malloc(), edit config.H to
  866. '#define HAS_SYMLINK', and you should be on your way.  Bill Wohler tells
  867. me that perl will run without editing config.H and with cc as well.  So
  868. just say no to use perl's malloc().
  869.  
  870. Doug Sewell <DOUG@YSUB.YSU.EDU> adds:
  871.  
  872. In addition to not using the perl-provided malloc, when asked if you
  873. want to edit config.sh, change 'cppstdin' from the wrapper-program
  874. to '/lib/cpp'.
  875.  
  876. The perl wrapper name is compiled into perl, and requires that you keep
  877. that file in the source directory, even if you blow away the rest of
  878. the source.  /lib/cpp will do the job by itself.  I suspect this will
  879. be fixed in perl 4.0pl11 Configure script.
  880.  
  881. Also, beware if you have gdbm installed per the instructions in the FAQ.
  882. Gdbm is compiled with bsdcc; perl (as I installed it, anyway) was built
  883. with cc, so I used the IBM-provided ndbm routines.
  884.  
  885.  
  886. 4.09: X-Windows
  887.  
  888. IBM has two releases of 3.2.3. The base version has X11R4 and Motif 1.1
  889. and the extended version has X11R5 as AIXwindows 1.2.3.
  890.  
  891. AIXwindows version 1.2.0 (X11rte 1.2.0) is X11R4 with Motif 1.1
  892. AIXwindows version 1.2.3 (X11rte 1.2.3) is X11R5 with Motif 1.1
  893. X11rte.motif1.2 1.2.3 is Motif 1.2 and requires AIXwindows 1.2.3
  894.  
  895.  
  896. 4.10: bash
  897.  
  898. Bash is ported and has some patches on prep.ai.mit.edu. The current
  899. version is 1.13.x and seems to work fine.
  900.  
  901.  
  902. 4.11: Elm
  903.  
  904. A very nice replacement for mail. Elm should be pretty straightforward,
  905. the only thing to remember is to link with -lcurses as the only
  906. curses/termlib library. You may also run into the problem listed under
  907. point 2.13 above.
  908.  
  909.  
  910. 4.12: Oberon 2.2
  911.  
  912. From: afx@muc.ibm.de (Andreas Siegert)
  913.  
  914. Oberon is Wirth's follow on to Modula-2, but is not compatible. A free
  915. version of Modula-3 is available from DEC/Olivetti at
  916. gatekeeper.dec.com. This is not a Modula-2 replacement but a new
  917. language. There are currently two M2 compilers for the 6000 that I know
  918. of. One from Edinburgh Portable Compilers, +44 31 225 6262 (UK) and the
  919. other from Gardens Point compiler +41 65 520311 (Switzerland).
  920.  
  921. Oberon can be obtained via anonymous ftp from neptune.inf.ethz.ch
  922. (129.132.101.33) under the directory Oberon/RS6000 or gatekeeper.dec.com
  923. (16.1.0.2).
  924.  
  925.  
  926. 4.13: Kermit
  927.  
  928. Get it from watsun.cc.columbia.edu (128.59.39.2), kermit/bin/cku189.tar.Z.
  929. Uncompress, untar, and "make rs6000", and it works.
  930.  
  931.  
  932. 4.14: Gnu dbm
  933. From: doug@cc.ysu.edu (Doug Sewell)
  934.  
  935. Here's the fixes for RS/6000's:
  936.  
  937. apply this to testgdbm.c:
  938. 158c158
  939. <   char opt;
  940. ---
  941. >   int opt;
  942. 166c166
  943. <   while ((opt = getopt (argc, argv, "rn")) != -1)
  944. ---
  945. >   while ((opt = getopt (argc, argv, "rn")) != EOF)
  946.  
  947. Apply this to systems.h:
  948. 111a112,114
  949. > #ifdef RS6000
  950. > #pragma alloca
  951. > #else
  952. 112a116
  953. > #endif
  954.  
  955. To compile, edit the Makefile.  Set CC to bsdcc (see /usr/lpp/bos/bsdport
  956. if you don't have 'bsdcc' on your system) and set CFLAGS to -DRS6000 and
  957. whatever options (-g, -O) you prefer.  Don't define SYSV.
  958.  
  959.  
  960. 4.15: tcsh
  961. From: cordes@athos.cs.ua.edu (David Cordes)
  962.  
  963. tcsh is available from tesla.ee.cornell.edu (pub/tcsh-6.00 directory)
  964. Compiles with no problems. You must edit /etc/security/login.cfg to
  965. permit users to change to this shell (chsh), adding the path where the
  966. shell is installed (in my case, /usr/local/bin/tcsh).
  967.  
  968. From: "A. Bryan Curnutt" <bryan@Stoner.COM>
  969.  
  970. Under AIX 3.2.5, you need to modify the "config.h" file, changing
  971.     #define BSDSIGS
  972. to
  973.     #undef BSDSIGS
  974.  
  975.  
  976. 4.16: Kyoto Common Lisp
  977.  
  978. The sources are available from cli.com. The kcl package is the needed
  979. base; also retrieve the latest akcl distribution. akcl provides a
  980. front-end that "ports" the original kcl to a number of different
  981. platforms. The port to the 6000 worked with no problems. However, you
  982. must be root for make to work properly with some memory protection
  983. routines.
  984.  
  985.  
  986. 4.17: Tcl/Tk
  987.  
  988. Current versions: Tcl 7.3, Tk 3.6. Available from sprite.berkeley.edu or
  989. harbor.ecn.purdue.edu.
  990.  
  991.  
  992. 4.18: Expect
  993. From: Doug Sewell <DOUG@YSUB.YSU.EDU>
  994.    
  995. To build the command-interpreter version, you must have the tcl library
  996. built successfully. The expect library doesn't require tcl.  Note:
  997. Expect and its library are built with bsdcc, so applications using
  998. the library probably also need to be developed with bsdcc.
  999.  
  1000. I ftp'd expect from ftp.cme.nist.gov.
  1001.  
  1002. You need to change several lines in the makefile.  First you need
  1003. to customize source and target directories and files:
  1004. #
  1005. TCLHDIR = /usr/include
  1006. TCLLIB = -ltcl
  1007. MANDIR = /usr/man/manl               (local man-pages)
  1008. MANEXT = l
  1009. BINDIR = /u/local/bin
  1010. LIBDIR = /usr/lib
  1011. HDIR = /usr/include
  1012. ...
  1013. Next set the compiler, switches, and configuration options:
  1014. #
  1015. CC = bsdcc
  1016. CFLAGS = -O
  1017. ...
  1018. PTY_TYPE = bsd
  1019. ...
  1020. INTERACT_TYPE = select
  1021. ...
  1022. Then you need to make these changes about line 90 or so:
  1023. comment out CFLAGS = $(CLFLAGS)
  1024. un-comment these lines:
  1025. CFLAGS = $(CLFLAGS) $(CPPFLAGS)
  1026. LFLAGS = ($CLFLAGS)
  1027.  
  1028. Then run 'make'.
  1029.  
  1030. You can't run some of the examples without modification (host name,
  1031. etc).  I don't remember if I ran all of them or not, but I ran enough
  1032. that I was satisfied it worked.
  1033.  
  1034.  
  1035. 4.19: Public domain software on CD
  1036. From: mbeckman@mbeckman.mbeckman.com (Mel Beckman)
  1037.  
  1038. The Prime Time Freeware CD collection is a package of two CD's and docs
  1039. containing over THREE GIGABYTES of compressed Unix software. It costs $69
  1040. >from Prime Time Freeware, 415-112 N. Mary Ave., Suite 50, Sunnyvalek, CA
  1041. 94086. Phone 408-738-4832 voice, 408-738-2050 fax. No internet orders as
  1042. far as I can tell.
  1043.  
  1044. I've extracted and compiled a number of the packages, and all have worked
  1045. flawlessly so far on my 220. Everything from programming languages to 3D
  1046. solid modeling is in this bonanza!
  1047.  
  1048. Ed: The O'Reilly book, Unix Power Tools, also contains a CD-ROM with lots
  1049. of useful programs compiled for the RS/6000, among other platforms.
  1050.  
  1051.  
  1052. 4.20: Andrew Toolkit
  1053.  
  1054. From: Gary Keim <gk5g+@andrew.cmu.edu>
  1055.  
  1056. The Andrew Toolkit Consortium of Carnegie Mellon University's School of
  1057. Computer Science has released new versions of the Andrew User
  1058. Environment, Andrew Toolkit, and Andrew Message System.
  1059.  
  1060. The Andrew User Environment (AUE) is an integrated set of applications
  1061. beginning with a 'generic object' editor, ez, a help system, a system
  1062. monitoring tool (console), an editor-based shell interface (typescript),
  1063. and support for printing multi-media documents. 
  1064.  
  1065. The Andrew Toolkit (ATK) is a portable user-interface toolkit that runs
  1066. under X11. It provides a dynamically-loadable object-oriented
  1067. environment wherein objects can be embedded in one another. Thus, one
  1068. could edit text that, in addition to containing multiple fonts, contains
  1069. embedded raster images, spreadsheets, drawing editors, equations, simple
  1070. animations, etc. These embedded objects can also be nested.
  1071.  
  1072. The Andrew Message System (AMS) provides a multi-media interface to mail
  1073. and bulletin-boards. AMS supports several mail management strategies
  1074. and implements many advanced features including authentication, return
  1075. receipts, automatic sorting of mail, vote collection and tabulation,
  1076. enclosures, audit trails of related messages, and subscription
  1077. management. It has interfaces that support ttys, personal computers, 
  1078. and workstations.
  1079.  
  1080. Release 5.1 of Andrew contains many bug fixes and updates. There is now
  1081. support for the new Internet MIME (Multipurpose Internet Mail Extensions)
  1082. standards for multipart, and multimedia mail. For more information on
  1083. MIME, please see the CHANGES files in the ftp directory on
  1084. emsworth.andrew.cmu.edu.
  1085.  
  1086. This release can be obtained as follows. The sources are available via
  1087. anonymous ftp from export.lcs.mit.edu (18.30.0.238) in the
  1088. ./contrib/andrew tree. For details, see ./contrib/andrew/README.
  1089.  
  1090. PATCH for AIX3.2: A patch to the AUIS 5.1 sources can be ftp'ed from
  1091. emsworth.andrew.cmu.edu (128.2.45.40) in ./aixpatch. For those without
  1092. internet access, a 3.5" diskette can be ordered for a nominal fee of $10
  1093. by sending, or faxing, a purchase order to the Consortium address below.
  1094.  
  1095. Andrew, as well as a variety of other CMU software, can also be ftp'ed
  1096. >from emsworth.andrew.cmu.edu (128.2.30.62). Those with AFS access look
  1097. at /afs/andrew.cmu.edu/itc/sm/releases/X.V11R5/ftp.
  1098.  
  1099. Remote Andrew Demo Service 
  1100.  
  1101. This network service allows you to run Andrew Toolkit applications
  1102. without obtaining or compiling the Andrew software. You need a host
  1103. machine running X11 on the Internet. A simple "finger" command will let
  1104. you experience ATK applications firsthand. You'll be able to compose
  1105. multimedia documents, navigate through the interactive Andrew Tour, and
  1106. use the Andrew Message System to browse through CMU's three thousand
  1107. bulletin boards and newsgroups.
  1108.  
  1109. To use the Remote Andrew Demo service, run the following command:
  1110.  
  1111.     finger help@atk.itc.cmu.edu 
  1112.  
  1113. The service will give you further instructions.
  1114.  
  1115. Information Sources
  1116.  
  1117. Your bug reports are welcome; kindly send them to
  1118. info-andrew-bugs@andrew.cmu.edu and we will periodically post a status
  1119. report to the mailing list info-andrew@andrew.cmu.edu. To be added to
  1120. the mailing list or make other requests, send mail to
  1121. info-andrew-request@andrew.cmu.edu.
  1122.  
  1123. We also distribute the following related materials:
  1124.  
  1125. ATK and AMS sources and binaries on CDROM. Binaries are available
  1126. for the following system types: 
  1127.  
  1128.             IBM RiscSystem/6000 
  1129.         Sun SparcStation 
  1130.         HP 700 Series 
  1131.         DECstation 
  1132.  
  1133. ATK and AMS sources on QIC and Iotamat tapes Hardcopies of the
  1134. documentation for ATK and AMS. Introductory video tape: Welcome to
  1135. Andrew: An Overview of the Andrew System. Technical video tape: The
  1136. Andrew Project: A Session at the Winter 1988 Usenix Conference.
  1137.  
  1138. More information about these materials is available from:
  1139.  
  1140.     Information Requests
  1141.     Andrew Toolkit Consortium
  1142.     Carnegie Mellon University
  1143.     4910 Forbes Avenue, UCC 214
  1144.     Pittsburgh, PA 15213-3890
  1145.     USA
  1146.     phone: +1-412-268-6710
  1147.     fax: +1-412-621-8081
  1148.     info-andrew-request@andrew.cmu.edu
  1149.  
  1150. There is also a netnews distribution list, comp.soft-sys.andrew, which
  1151. is identical to the info-andrew list except that it does not support the
  1152. multi-media capabilities of info-andrew.
  1153.  
  1154.  
  1155. 4.21: sudo
  1156.  
  1157. Allows processes to assume other uids. Version 1.1 (most recent) can be
  1158. obtained from csn.org:/pub/sudo and comprehends AIX.
  1159.  
  1160.  
  1161. 4.22: Flexfax and other fax software
  1162. From: robmack@bsc.no (Rob MacKinnon)
  1163.  
  1164. sgi.com:/sgi/fax to get FlexFax v2.2.1. It supports many types of Class
  1165. 1/2 fax modems and several UNIX systems including AIX 3.2.3 or greater. 
  1166. There is also a fax modem review document at the same site as
  1167. sgi.com:/pub/fax/bakeoff. The FlexFax related files on sgi.com are
  1168. replicated on ftp.bsc.no as well.
  1169.  
  1170. Note: FlexFax 2.4.3 can be ftp'ed from ftp.ee.lbl.gov but I don't know
  1171. if that's an upgrade from the SGI version.
  1172.  
  1173. From: michael@hal6000.thp.Uni-Duisburg.DE (Michael Staats)
  1174.  
  1175. We're using mgetty+sendfax for the basic modem I/O, I wrote a printer
  1176. backend for the modem so that users can send faxes as easy as they print
  1177. postscript. I also wrote a little X interface composer to generate a
  1178. fax form that makes sending faxes very easy. You can find these
  1179. programs at hal6000.thp.Uni-Duisburg.DE under /pub/source.
  1180.  
  1181. program                comment
  1182.  
  1183. mgetty+sendfax-0.14.tar.gz    basic modem I/O, needs hacking for AIX
  1184. X11/xform-1.1.tar.gz             small and simple X interface composer
  1185.                 with an example fax form. Needs
  1186.                 libxview.a incl. headers.
  1187. faxiobe.tar.gz            fax backend, needs configuring for
  1188.                 your local site
  1189.  
  1190. If you need a binary version of libxview.a and the headers you'll find
  1191. them under /pub/binaries/AIX-3-2/lxview.tar.gz.
  1192.  
  1193.  
  1194. 4.23: lsof
  1195. From: abe@vic.cc.purdue.edu (Vic Abell)
  1196.  
  1197. Q. How can I determine the files that a process has opened?
  1198. Q. How can I locate the process that is using a specific network address?
  1199. Q. How can I locate the processes that have files open on a file system?
  1200.  
  1201. A. Use lsof (LiSt Open Files).
  1202.  
  1203. Lsof is available via anonymous ftp from vic.cc.purdue.edu
  1204. (128.210.15.16) in pub/lsofVVVtar.Z where VVV is the version number,
  1205. currently 229.
  1206.  
  1207. ______________________________________________________________________________
  1208. 5.00: Third party products
  1209.  
  1210. [ Ed.: Entries in this section are edited to prevent them from looking
  1211.   like advertising. Prices given may be obsolete. Companies mentioned
  1212.   are for reference only and are not endorsed in any fashion. ]
  1213.  
  1214.  
  1215. 5.01: IBM list of third party products
  1216. From: marc@sti.com (Marc Pawliger)
  1217.  
  1218. Marc Pawliger post an extensive list periodically to this newsgroup
  1219. about various third party hardware products for the RS/6000. This list
  1220. can also be ftp'd from ibminet.awdpa.ibm.com.
  1221.  
  1222. 3rd Party H/W Guide still there, but no longer maintained, Marc
  1223. Pawliger has left IBM.
  1224.  
  1225. 5.02: Disk/Tape/SCSI
  1226. From: anonymous
  1227.  
  1228. - Most SCSI disk drives work (IBM resells Maxtor, tested Wren 6&7 myself);
  1229.   use osdisk when configuring (other SCSI disk).
  1230.  
  1231. - Exabyte: Unfortunately only the ones IBM sells are working.
  1232.   A few other tape drives will work; 
  1233.   use ostape when configuring (other SCSI tape).
  1234.  
  1235. - STK 3480 "Summit": Works with Microcode Version 5.2b
  1236.  
  1237.  
  1238. From: bell@hops.larc.nasa.gov (John Bell)
  1239.                
  1240. In summary, third party tape drives work fine with the RS/6000 unless 
  1241. you want to boot from them. This is because IBM drives have 'extended 
  1242. tape marks', which IBM claims are needed because the standard marks 
  1243. between files stored on the 8mm tape are unreliable. These extended 
  1244. marks are used when building boot tapes, so when the RS/6000 boots, it 
  1245. searches for an IBM tape drive and refuses to boot without it.
  1246.  
  1247. From: jrogers@wang.com (John Rogers)
  1248.  
  1249. On booting with non-IBM SCSI tape drives: I haven't tried it myself but
  1250. someone offered:
  1251.  
  1252. Turn machine on with key in secure position.
  1253. Wait until LED shows 200 and 8mm tape has stopped loading.
  1254. Turn key to service position.
  1255.  
  1256.  
  1257. From: amelcuk@gibbs.clarku.edu (Andrew Mel'cuk)
  1258.  
  1259. The IBM DAT is cheap and works.  If you get all the patches beforehand
  1260. (U407435, U410140) and remember to buy special "Media Recognition
  1261. System" tapes (Maxell, available from APS 800.443.4461 or IBM #21F8758)
  1262. the drive can even be a pleasure to use.  You can also flip a DIP switch
  1263. on the drive to enable using any computer grade DAT tapes (read the
  1264. hardware service manual).
  1265.  
  1266. Other DAT drives also work.  I have tried the Archive Python (works) and
  1267. experimented extensively with the Archive TurboDAT.  The TurboDAT is a
  1268. very fast compression unit, is not finicky with tapes and doesn't
  1269. require the many patches that the IBM 7206 does.  Works fine with the
  1270. base AIX 3.2 'ost' driver.
  1271.  
  1272.  
  1273. From: pack@acd.ucar.edu (Daniel Packman)
  1274.  
  1275. >>You can boot off of several different brands of non-IBM Exabytes.
  1276. >>At least TTI and Contemporary Cybernetics have done rather complete
  1277. >>jobs of emulating genuine IBM products.
  1278.  
  1279. A model that has worked for us from early AIX 3.1 through 3.2 is a TTI
  1280. CTS 8210.  This is the old low density drive.  The newer 8510 is dual
  1281. density (2.2gig and 5gig).  Twelve dip switches on the back control the
  1282. SCSI address and set up the emulation mode.  These drives have a very
  1283. useful set of lights for read-outs (eg, soft error rate, tape remaining,
  1284. tape motion, etc.).
  1285.  
  1286.  
  1287. 5.03: Memory
  1288.  
  1289. I got a flyer from Nordisk Computer Services (Portland 503-598-0111, 
  1290. Seattle 206-242-7777).  Some sample prices:
  1291.  
  1292.       16 MB Upgrade Kit   $  990
  1293.       32 MB Upgrade Kit   $1,700
  1294.       64 MB Upgrade Kit   $3,300
  1295.  
  1296. 5xx machines have 8 memory slots, 3x0s have 2, and 3x5s have only one.
  1297. You need to add memory in pairs for the 5xx machines.
  1298.  
  1299. Models 220, 230 and 250 can use "PS/2" style SIMM memory.  All have 8
  1300. SIMM sockets.  60ns or better is needed for the 250, 70ns should be OK
  1301. in the 220 and 230.  The 220 and 230 are limited to 64MB of memory,
  1302. the 250 is limited to 256MB.
  1303.  
  1304.  
  1305. 5.04: Others
  1306. From: anonymous
  1307.        
  1308. IBM RISC System/6000 Interface Products
  1309.  
  1310. National Instruments Corporation markets a family of instrumentation
  1311. interface products for the IBM RISC System/6000 workstation family.  The
  1312. interface family consists of three products that give the RISC
  1313. System/6000 connectivity to the standards of VMEbus, VXIbus and GPIB. 
  1314. For more information, contact National Instruments Corporation,
  1315. 512-794-0100 or 1-800-433-3488.
  1316.  
  1317.  
  1318. 5.05: C++ compilers
  1319.  
  1320. Several C++ compilers are available. You can choose from Glockenspiel,
  1321. Greenhills, IBM's xlC (sold seperatly :), and GNU's g++. Glockenspiel
  1322. may now be part of Computer Associates. Comeau Computing
  1323. (718-945-0009) offers Comeau C++ 3.0 with Templates. For a full
  1324. development environment there's ObjectCenter's C++ (formerly Saber
  1325. C++).
  1326.  
  1327.  
  1328. 5.06: Memory leak detectors
  1329.  
  1330. IBM's xlC comes with a product called the HeapView debugger that can
  1331. trace memory problems in C and C++ code.
  1332.  
  1333. SENTINEL has full memory access debugging capabilities including detection 
  1334. of memory leaks.  Contact info@vti.com (800) 296-3000 (703) 430-9247.
  1335.  
  1336. Insight from ParaSoft (818) 792-9941.
  1337. There is also a debug_malloc posted in one of the comp.sources groups.
  1338.  
  1339. From: dad@adonis.az05.bull.com (Dave Dennerline)
  1340.   Purify from Pure software (408) 720-1600.
  1341.   TestCenter from Centerline (800) 669-2687.
  1342. Purify and TestCenter are not availible for the RS/6000 :(
  1343.  
  1344.  
  1345. 5.07: PPP
  1346.  
  1347. PPP from Morningstar (sales@morningstar.com or marketing@morningstar.com)
  1348. (800) 558-7872.
  1349.  
  1350. ______________________________________________________________________________
  1351. 6.00: Miscellaneous other stuff
  1352.  
  1353. 6.01: Can I get support by e-mail?
  1354.  
  1355. AIXServ is a service tool that allows users on internet and usenet to
  1356. report problems via unix mail. AIXServ is free. To receive instructions 
  1357. on using AIXServ, send a note with "Subject: package" to one of the
  1358. following e-mail addresses:
  1359.  
  1360.     Internet:   aixbugs%aixserv@uunet.UU.NET
  1361.     Usenet:     uunet.UU.NET!aixserv!aixbugs
  1362.                     aixbugs@austin.ibm.com     (transactions request)
  1363.                     services@austin.ibm.com    (administrivia)
  1364.                     aasc@austin.ibm.com        (test cases under 100KB)
  1365.  
  1366. Using AIXServ, customers have the ability to 1) open new problem reports,
  1367. 2) update existing problem records, and 3) request a status update on an
  1368. existing problem record. Currently this service is available to United
  1369. States customers only.
  1370.  
  1371. Canada:
  1372.  
  1373. Gary Tomic mentioned that Canadian customers can get support from their
  1374. BBS, cac.toronto.ibm.com at 142.77.253.16.
  1375.  
  1376. Germany:
  1377.  
  1378. Thomas Braunbeck reported that German customers with ESS (extended
  1379. software service) contracts can get support by e-mail too. They can 
  1380. obtain information by sending mail with Subject: help to 
  1381. aixcall@aixserv.mainz.ibm.de.
  1382.  
  1383. Various flavors of service offerings are available. Contact your IBM rep
  1384. for details.
  1385.  
  1386.  
  1387. 6.02: List of useful faxes
  1388.  
  1389. You can get some informative faxes by dialing IBM's Faxserver at
  1390. 1-800-IBM-4FAX. If you're calling for the first time, push 3 then 2 to
  1391. request a list of RS/6000 related faxes.
  1392.  
  1393. document number                       Title
  1394. ---------------  -----------------------------------------------------
  1395.      1453        Recovering from LED 518 in AIX 3.2
  1396.      1457        Recovering from LED 552 in AIX 3.1 and 3.2
  1397.      1461        Alternative Problem Reporting Methods
  1398.      1470        Recovering from LED 223/229, 225/229, 233/235, 221/229, or 221
  1399.      1537        How to Get AIX Support
  1400.      1719        Performance Analyzer/6000
  1401.      1721        Recovering from LED 553 in AIX 3.1 and 3.2
  1402.      1746        Recovering from LED 551 in AIX 3.1 and 3.2
  1403.      1755        Recovering Volume Groups
  1404.      1802        Repairing File Systems with fsck in AIX 3.1 and 3.2
  1405.      1803        How to Take a System Dump
  1406.      1804        Setting Up a Modem With the RS/6000
  1407.      1845        Using iptrace to Track Remote Print Jobs
  1408.      1867        Clearing the Queuing System
  1409.      1895        Removing/Replacing a Fixed Disk
  1410.      1896        Tape Drive Densities and Special Files
  1411.      1897        Tips on mksysb for AIX 3.2
  1412.      1909        UUCP (BNU) Helpful Information
  1413.      1910        Synchronizing Disk Names
  1414.      1988        Recovering from LED 201 in AIX 3.1 and 3.2
  1415.      1989        Recovering from LED 727 in AIX 3.2
  1416.      1991        Recovering from LED c31 in AIX 3.1 and 3.2
  1417.      2079        AIX 3.2.4
  1418.      2121        AIX 3.2.4 Installation Tips
  1419.      2267        How to reduce /usr in AIX 3.2
  1420.      2443        Man pages for AIX 3.2
  1421.      2446        How to set up sar
  1422.      2447        How to reduce /tmp
  1423.      2448        Installing a 5 GB tape drive
  1424.      2462        Bosboot diskettes
  1425.      2465        How to remove ptfs from the ODM
  1426.  
  1427.  
  1428. 6.03: List of 3.2 ptfs
  1429.  
  1430. A list of the latest ptfs for 3.2 can be ftp'd from
  1431. ibminet.awdpa.ibm.com but the list is no longer being maintained as of
  1432. 3/14/94.
  1433.  
  1434. 6.04: Some RS232 hints
  1435. From: graeme@ccu1.aukuni.ac.nz, sactoh0.SAC.CA.US!jak
  1436.  
  1437. Q: How do you connect a terminal to the RS232 tty ports when not using
  1438.    the standard IBM cable & terminal transposer?
  1439. A: 1- Connect pins 2->3, 3->2, 7->7 on the DB25's
  1440.    2- On the computer side, most of the time cross 6->20 (DSR, DTR).
  1441.       Some equipment may require connecting 6, 8, and 20 (DSR, DCD, DTR).
  1442.  
  1443. Also, pin 1 (FG) should be a bare metal wire and the cable should be
  1444. shielded with a connection all the way through. Most people don't run
  1445. pin 1 because pins 1 & 7 (SG) are jumpered on many equipment.
  1446.  
  1447. When booting from diskettes, the port speed is always 9600 baud.  If you
  1448. use SMIT to set a higher speed (38400 is nice) for normal use, remember
  1449. to reset your terminal before booting.
  1450.  
  1451. Q: How do you connect a printer to the RS232 tty ports
  1452. A: 1- Connect pins 2->3, 3->2, 7->7 on the DB25's
  1453.    2- On the computer side, loop pins 4->5 (CTS & RTS)
  1454.  
  1455.  
  1456. 6.05  What publications are available for AIX and RS/6000?
  1457.  
  1458. The following are free just for the asking:
  1459.  
  1460. 1. RS/Magazine
  1461.    P.O. Box 3272
  1462.    Lowell, MA 01853-9876
  1463.    e-mail: aknowles@expert.com (Anne Knowles, editor)
  1464.  
  1465. 2. AIXpert
  1466.    IBM Corporation
  1467.    Mail Stop 36
  1468.    472 Wheelers Farms Road
  1469.    Milford, CT 06460
  1470.    FAX: (203) 783-7669
  1471.  
  1472. 3. RiSc World
  1473.    P.O. Box 399
  1474.    Cedar Park, TX 78613
  1475.    FAX: (512) 331-3900
  1476.    Usenet: {cs.utexas.edu,execu,texbell}!pcinews!rsworld
  1477.  
  1478.  
  1479. These manuals should be available from your favorite IBM office.
  1480.  
  1481. SC23-2204-02  Problem Solving Guide
  1482. SC23-2365-01  Performance Monitoring and Tuning Guide for AIX 3.2
  1483. SA23-2629-07  Service Request Number Cross Reference, Ver 2.2
  1484. SA23-2631-05  Diagnostic Programs: Operator Guide
  1485. SA23-2632-05  Diagnostic Programs: Service Guide
  1486. SA23-2643-01  Hardware Technical Reference: General Information
  1487. SA23-2646-01  Hardware Technical Reference: Options and Devices
  1488.  
  1489.  
  1490. 6.06: Some acronyms
  1491.  
  1492. APAR - authorized program analysis report
  1493. BOS  - Basic Operating System
  1494. DCR  - design change request
  1495. LPP  - Licensed Program Product
  1496. ODM  - Object Database Manager
  1497. PRPQ - programming request for price quotation
  1498. PTF  - Program Temporary Fix
  1499. SMIT - System Management Interface Tool
  1500.  
  1501.  
  1502. 6.07: How do I get this by mailserver or ftp?
  1503.  
  1504. Since the articles are crossposted to news.answers, any archive carrying
  1505. that newsgroup will also have these articles. In particular, try
  1506. rtfm.mit.edu in the directory pub/usenet/news.answers. This FAQ is
  1507. archived as "aix-faq/faq/part[1-3]".
  1508.  
  1509.  
  1510. 6.08: Hypertext version of the FAQ
  1511. From: Michael D. Fischer <greendog@max.physics.sunysb.edu>
  1512.  
  1513. Mike has converted this AIX FAQ into HTML code for use from XMosaic or
  1514. other WWW browsers. If you have XMosaic and want to take a look, the URL is
  1515.  
  1516. http://insti.physics.sunysb.edu/faq/index.html
  1517.  
  1518.  
  1519. 6.09: Where can I send suggestions for tools?
  1520.  
  1521. If you have any suggestions or comments about tools, whether currently or 
  1522. desirable to be in AIX, send a note to aix_tool_ideas@austin.ibm.com.
  1523.  
  1524. _____________________________________________________________________________
  1525. 7.00: Contributors
  1526.  
  1527. The following persons have contributed to this list.  If you want to
  1528. contribute anonymously, just let me know - but do tell me who you are.
  1529. I apologise if I missed out anyone.
  1530.  
  1531. Thank you all, this would definitely not be the same without _your_ input.
  1532.  
  1533. Luis Basto            <basto@
  1534. Rudy Chukran            <chukran@austin.VNET.IBM.COM>
  1535. Christopher Carlyle O'Callaghan    <asdfjkl@wam.umd.edu>
  1536. Poul-Henning Kamp        <phk@data.fls.dk>
  1537. Richard Wendland                <richard@praxis.co.uk>
  1538. Ge van Geldorp            <ge@dutlru2.tudelft.nl>
  1539. Chris Jacobsen            <jacobsen@sbhep2.phy.sunysb.edu>
  1540. Peter Jeffe            <peter@ski.austin.ibm.com>
  1541. Jean-Francois Panisset        <panisset@thunder.mcrcim.mcgill.edu>
  1542. John Cary            <cary@boulder.colorado.edu>
  1543. Vijay Debbad            <vijay@ingres.com>
  1544. Dick Karpinski            <dick@ccnext.ucsf.edu>
  1545. Konrad Haedener            <haedener@iac.unibe.ch>
  1546. Doug Sewell            <DOUG@YSUB.YSU.EDU>
  1547. David Cordes            <cordes@athos.cs.ua.edu>
  1548. Graeme Moffat            <g.moffat@aukuni.ac.nz>
  1549. Andrew Pierce            <pierce@claven.cambridge.ibm.com>
  1550. Stephen Linam            <sdl@glasnost.austin.ibm.com>
  1551. Jerome Park            <jerome%aixserv@uunet.UU.NET>
  1552. Konrad Haedener            <haedener@iacrs1.unibe.ch> 
  1553. Steve Roseman            <lusgr@chili.CC.Lehigh.Edu>
  1554. John Burton            <burton@asdsun.larc.nasa.gov>
  1555. Thierry Forveille        <FORVEILL@FRGAG51.BITNET>
  1556. Joubert Berger            <afc-tci!joubert>
  1557. Minh Tran-Le            <tranle@intellicorp.com>
  1558. Paul Amaranth            <amaranth@vela.acs.oakland.edu>
  1559. Mark Whetzel            <markw@airgun.wg.waii.com>
  1560. Daniel Packman            <pack@acd.ucar.edu>
  1561. Ken Bowman            <bowman@uiatma.atmos.uiuc.edu>
  1562. Cary E. Burnette        <kerm@mcnc.org>
  1563. Christophe Wolfhugel        <wolf@grasp1.univ-lyon1.fr>
  1564. Leonard B. Tropiano        <lenny@aixwiz.austin.ibm.com>
  1565. Bill Wohler            <wohler@sap-ag.de>
  1566. James Salter            <jsalter@ibmpa.awdpa.ibm.com>
  1567. Witold Jan Owoc            <witold@enme.ucalgary.ca>
  1568. Marc Kwiatkowski        <marc@ultra.com>
  1569. Ronald S. Woan            <woan@exeter.austin.ibm.com>
  1570. Mijan Huq            <huq@hagar.ph.utexas.edu>
  1571. Herbert van den Bergh        <hbergh@nl.oracle.com>
  1572. Michael Stefanik        <mike@bria.UUCP>
  1573. John F. Haugh            <jfh@rpp386.cactus.org>
  1574. Ed Kubaitis            <ejk@ux2.cso.uiuc.edu>
  1575. Jaime Vazquez            <jaime@austin.vnet.ibm.com>
  1576. Bjorn Engsig            <bengsig@oracle.com>
  1577. Frank Kraemer             <kraemerf@franvm3.VNET.IBM.COM>
  1578. Andreas Siegert                 <afx@muc.ibm.de>
  1579. Thomas Braunbeck                <braunbec@aixserv.mainz.ibm.de>
  1580. Marc Pawliger            <marc@sti.com>
  1581. _____________________________________________________________________________
  1582.  
  1583. Opinions expressed here have nothing to do with IBM.
  1584.  
  1585. All trademarks are the property of their respective owners.
  1586.  
  1587. -- 
  1588. Jeff Warrington
  1589. jwarring@flaixy.fd.amsinc.com  or  a165@lehigh.edu  
  1590.  
  1591.